package com.ruoyi.client.mapper;

import com.ruoyi.client.pojo.vo.CartVo;
import com.ruoyi.myshop.domain.Cart;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 购物车Mapper接口
 * 与 ClientCartService 接口的操作一一对应，提供数据访问层支持
 */
public interface ClientCartMapper {

    /**
     * 更新购物车记录（支持动态字段更新）
     * @param cart 购物车对象（需包含id，其他字段非空则更新）
     * @return 影响行数
     */
    int update(Cart cart);

    /**
     * 全选/全不选用户的所有购物车项
     * @param userId 用户ID（当前登录用户）
     * @param isChecked 勾选状态（1=选中，0=未选中）
     * @return 影响行数
     */
    int updateIsCheckedAllByUserId(@Param("userId") Long userId, @Param("isChecked") Integer isChecked);

    /**
     * 批量更新用户指定购物车项的勾选状态
     * @param userId 用户ID
     * @param isChecked 勾选状态（1=选中，0=未选中）
     * @param ids 购物车记录ID列表（指定要更新的项）
     * @return 影响行数
     */
    int updateBatchIsCheckedByUserId(@Param("userId") Long userId, @Param("isChecked") Integer isChecked, @Param("ids") List<Long> ids);

    /**
     * 通过购物车记录ID删除单条商品
     * @param id 购物车记录ID（shop_cart.id）
     * @return 影响行数
     */
    int deleteByPrimaryKey(Long id); // 修复：方法名改为deleteByPrimaryKey，与Mapper.xml中ID一致

    /**
     * 批量删除购物车商品（按ID数组）
     * @param ids 购物车记录ID数组
     * @return 影响行数
     */
    int deleteBatch(Long[] ids); // 修复：参数改为Long[]数组，与Mapper.xml中foreach collection="array"适配

    /**
     * 清空用户的所有购物车记录
     * @param userId 用户ID（当前登录用户）
     * @return 影响行数
     */
    int deleteByUserId(Long userId);

    /**
     * 新增购物车记录（支持动态字段插入）
     * @param cart 购物车对象（含用户ID、商品ID、数量等信息）
     * @return 影响行数（主键会自动回显到cart对象的id字段）
     */
    int insert(Cart cart);

    /**
     * 根据用户ID和商品ID查询购物车记录（判断商品是否已在购物车中）
     * @param userId  用户ID
     * @param goodsId 商品ID
     * @return 购物车记录（不存在则返回null）
     */
    Cart selectByUserIdAndGoodsId(@Param("userId") Long userId, @Param("goodsId") Long goodsId); // 修复：返回值改为Cart，与Service层逻辑一致

    /**
     * 查询用户的所有购物车项（关联商品信息）
     * @param userId 用户ID（当前登录用户）
     * @return 购物车项列表（含商品名称、价格、图片等）
     */
    List<CartVo> listByUserId(Long userId);

    /**
     * 查询用户已勾选的购物车项（关联商品信息，用于结算）
     * @param userId 用户ID（当前登录用户）
     * @return 已勾选的购物车项列表
     */
    List<CartVo> listIsCheckedByUserId(Long userId);

    /**
     * 原子更新购物车项数量（解决并发问题）
     * @param id 购物车记录ID
     * @param addCount 增减数量（正数增加，负数减少）
     * @return 影响行数
     */
    int updateCount(@Param("id") Long id, @Param("addCount") Long addCount); // 修复：方法名改为updateCount，与Mapper.xml中ID一致

    /**
     * 通过ID查询购物车项详情
     * @param id 购物车记录ID
     * @return 购物车项详情（不含商品关联信息）
     */
    Cart selectById(Long id); // 修复：返回值改为Cart，与Service层归属权校验逻辑一致

    /**
     * 批量通过ID查询购物车记录（用于批量删除归属权校验）
     * @param ids 购物车记录ID列表
     * @return 购物车记录列表
     */
    List<Cart> selectByIds(@Param("ids") List<Long> ids); // 新增：与Mapper.xml中selectByIds接口对应

    /**
     * 统计用户购物车中指定ID的记录数（用于校验ID合法性）
     * @param userId 用户ID
     * @param ids 购物车记录ID列表
     * @return 匹配的记录数
     */
    int countByUserIdAndIds(@Param("userId") Long userId, @Param("ids") List<Long> ids);

    /**
     * 查询用户指定勾选状态的购物车项
     * @param userId 用户ID
     * @param isChecked 勾选状态（1=选中，0=未选中）
     * @return 购物车项列表
     */
    List<CartVo> listByUserIdAndIsChecked(@Param("userId") Long userId, @Param("isChecked") int isChecked);
}